home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Aminet 5
/
Aminet 5 - March 1995.iso
/
Aminet
/
util
/
cli
/
filefind.lha
/
File Finder.doc
next >
Wrap
Text File
|
1995-02-02
|
11KB
|
378 lines
01108730-0
Version
1.0
Mark Melton
©1995
Generated with Heddley v1.1
Heddley v1.1 (C) Edd Dumbill 1994
- Page 1 -
1. File Finder
File Finder
Release Version 1.05 2nd Feb 1995
written by Mark Melton
email u9326383@radon.sys.uea.ac.uk (until July 96)
Contents
Copyright
Introduction
Requirements
Installation
Usage
Problems
Future plans
Acknowledgements
Suggestions/Registration
2. Copyright
Copyright
This product may be freely distributed as long as certain conditions are met.
1. This product may only be distributed in a compleat form this doc file including copyright message m
ust be included .
2. This product may be freely distributed via the internet or any other non commercial venture.
3. This program my only be distributed by a commercial PD library only with my express
permission, for which a charge will be made.
4. No charge may be made for the distribution of this product except for a nominal fee for the media on
which it is transmitted, without my permission.
5. This product may not be included on any magazine coverdisk without my written consent, except for th
e Amiga Shopper magazine based in the UK.
6. This product will not be included in any commercial package, unless my written consent is obtained
before distribution.
By distributing, using or copying the product you indicate your acceptance of the above conditions.
Disclaimer
This program is provided as is, and no liability is accepted for any dammage caused to you, your machi
ne, or for that matter anything else. Hey if using this program causes WW3 don't blame me OK.
3. Introduction
Introduction
This program is used for finding things, still you probably worked that out from the name ;-).
I wrote it mainly because I have access to several Amigas (TM), with rather
large hard-drive's. I found there was a need to quickly find the location of files on
the machines as many of them have files stored in different ways. There was also
the article in the Amiga Shopper magazine on a file finding utility. I modified their code a bit and
added substantial amounts, and came up with this program.
Current features in version 1.1
Find any file on a disk, using standard AmigaDos(TM) file matching patterns.
Fully implemented as a commodity, with hotkey etc.
- Page 2 -
3. Introduction
Limit search size parameters, only files in a certain size range are checked.
+ a few bug fixes ;->
4. Requirements
Requirements for File Finder.
It is essential that you have at least kickstart & Workbench 2.04.
Other than that there are no further restrictions, well appart from having an amiga :-).
The program has been written on an A1200 with 50Mhz GVP A1230-II.
It has been tested using enforcer and causes no enforcer hits so it should be OK on all amigas.
Tested on plain A1200, A4000/040, A4000/030/ and an A3000. I would be grateful for people to
confirm its operation on other machines, e.g. A500+, A2000, etc.
5. Usage
Usage
This program was designed with one goal in mind, to be simple to use. It
is for this reason that the standard "look" of the workbench has been used. The program has
three main interface area's. The file list at the top (initialy blank), the search pa ameter
control's, contailed within the "raised" box, and the program control functions at the bottom. A
screen shot of this is included and can be viewed by pressing this button in WB3.0 or above, or by
using the display in the utilities drawer.
Firstly the Search parameter gadgets will be described.
The status gadget informs the user of the current status of the program.
It is not selectable by ths user.
The Path gadget, keyboard shortcut P, is used to specify the drive or
directory in which to look for the file. Limiting the search to a particular directory saves time
by reducing the number of files which have to be searched. e.g.
DH0:
This would search all of DH0:, whereas
DH0:Utilities/
would only search the directory dh0:utilities.
The Pattern gadget, keyboard shortcut T, is used to specify the
file for which to search. Standard AmigaDOS file patterns are accepted, to save you digging out
your AmigaDOS manual, if you even have one, here are the pattern's
? Matches any single character.
#<p> Matches zero or more occurances of <p>.
<p1>|<p2> Matches if either <p1> or <p2> matches.
-<p> Matches everything but <p>.
(<p1><p2>...) Groups items together.
% Matches the null string.
[<p>-<p>] Determines a character range.
Now unless you've used AmigaDOS extensivly, that lot will be about as
- Page 3 -
5. Usage
clear as mud. So here's the english translation.
A?B Matches any three letter word begining in A and ending in
B. Such as AcB, AzB, ABB, etc.
A#BC Matches any name beginning in A and ending in C, with
any number of B's in between. Such as ABC, ABBC, ABBBC, etc.
ABC#? Matches any name beginning ABC. Such as ABCD, ABCPIC.info, etc.
#?XYZ Matches any name ending XYZ. Such as MARK_XYZ, PICXYZ, etc.
ABC#?XYZ Matches any name beginning ABC and ending XYZ. Such as ABCXYZ, ABCMARKXYZ, etc.
A(B|C)D Matches ABD or ACD.
~(XYZ) Matches anything but XYZ.
~(#?.info) Matches anything not ending in .info.
A#(BC) Matches any name begining with A followed by any number
of BC's. Such as ABC, ABCBC, ABCBCBC, etc.
A(B|D|%)C Matches any name starting with A ending with C with B, D
or nothing in between. Such as ABC, ADC or AC.
[A-D]#? Matches any name beginning with A, B, C or D.
The Size button, keyboard shortcut S, opens the Search Size
limit window containing three gadgets. They are the info gadget, which is a small reminder of what to
do. The Max Size gadget, keyboard shortcut M, where the maximum file size to include in the search is
put, and the Min Size gadget, keyboard shortcut S, where the minimum file size to inculde in the
search is put. The search size limit window does not have to be closed after use and can be left open.
To ignore a maximum file size limit enter a value of 0. e.g.
Max size = 0 Min size = 1000
would only look for files over 1000 bytes (1Kb) in size.
Max size = 10000 Min size = 5000
would only look for files over 5000 bytes (5Kb) long but under 10000 bytes (10 Kb).
The List Gadget.
This is where the list of files that match the search parameters will
appear. If the list gadget is clicked on, details of the file selected, will appear in the
info window. This provides details such as the creation date of the file, its name, the pat
to the file and its size. The info window can be left open when
selecting other files, there details will replace those already in the info window. Program control
gadgets.
Quit, keyboard shortcut Q, exits the program immediatly. Warning, you will
not be asked to confirm a quit request.
Find, keyboard shortcut F, commences the search with the current search parameters.
Abort, keyboard shortcut A, aborts the current search operation. This
will stop the search at the point it had reached when the abort button was pressed. Search
operations must be allowed to compleat or aborted before any other commands can be used, su h as Quit.
Print, keyboard shortcut R, print's the current contents of the list to the current prefs printer.
- Page 4 -
5. Installation
6. Installation
Installation
This couldn't possibly be easier. Simply drag the File Finder icon to
wherever you want it to be put. I would recomend either your utilities drawer, tools drawer or
preferbly your WBStartup drawer.
The documentation consists of the AmigaGuide format doc, and a plain text file. Also there is also
a picture of the interface this should ideally be kept in the same place as the amigaguide doc.
New to version 1.05.
TOOLTYPES
(See page 10-23 of the WorkBench 3.0 manual.)
CX_HOTKEY="ctrl F" or any other combination you want. This key combination will cause the program
to popup its GUI(Graphical user interface) if it is currently "Hidden".
Use the tooltype DONOTWAIT if you run the program from the WBStartup drawer.
The CX_POPUP tooltype determinew if the program opens its GUI on startup.
7. Problems
Problems
Well, there are no known problems with this program.
If you discover any problems with this program send me the details,
such as what the problem is, what sort of machine you use machine, you KS and WB version numbers
and an address where you can be contacted.
8. Future plans
Future plans
Firstly to implement the date limit (nearly done), and type limit features.
You never know, some shareware subscriptions might encorage me to get these features implemented :->
Also I would welcome any suggestions for improvements or new features.
Contacts
9. Acknowledgements
Acknowledgements
Thanks go to the Amiga Shopper magazine in the UK for
providing the inspiration for this program. This program is loosly based on a program that they ran as
a C programming tutorial, but has had considreable enhancements, and extra features added.
10. Suggestions/Registration
Firstly I can be contacted by Email or snail mail.
Email (Bugs, sugestions only)
u9326383@radon.sys.uea.ac.uk
I will have access to this account until at least summer 1996.
Snail mail( registration requests, bugs, sugestions)
- Page 5 -
10. Suggestions/Registration
Mr M D Melton,
1 Hawksmoor close,
North Hykeham,
Lincoln,
England,
LN6 9PN
Registration
What benifits will registration bring you, well appart from making you only very slightly poorer, it wi
ll brin g my eternal gratitude, and the very latest version of this program. What do I ask for thi
s program, which has been written in my spare time w hile studying for my degree, as a possible
method of suplementing my income :->
Full registration £15, yes thats all, just 15 GB pounds, 40 DM or $25.